---
title: 快速上手
sidebarTitle: 快速上手
---

快速入门指南将会向你展示最快速的安装、配置、启动方式。

完成本指南后，你将拥有一个可以自由集成不同 MCP 的服务，允许你可有控制提供给小智的 MCP 工具。

<Info>
  **前期准备**:
  在开始之前，你至少需要有一个小智硬件设备，并已添加至小智官方服务端。
</Info>

## 环境准备

请先安装好 node 与 pnpm。

<Info>如果你已经准备好 node & pnpm 可以跳过此步骤</Info>

<Steps>
  <Step title="安装Node">
    请前往 [Node官方安装地址](https://nodejs.org/en/download) 进行安装，并验证安装是否成功。

    以下为 node:22(LTS) + pnpm 的安装方式
    <CodeGroup>
      ```bash macos / linux
      # 下载并安装 nvm:
      curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

      # 重启shell
      \. "$HOME/.nvm/nvm.sh"

      # 下载并安装 Node.js:
      nvm install 22

      # 验证 Node.js 版本:
      node -v # 应该打印出 "v22.19.0".

      # 下载并安装 pnpm:
      corepack enable pnpm

      # 验证 pnpm 版本:
      pnpm -v
      ```

      ```bash windows
      # 下载并安装 Chocolatey:
      powershell -c "irm https://community.chocolatey.org/install.ps1|iex"

      # 下载并安装 Node.js:
      choco install nodejs --version="22.19.0"

      # 验证 Node.js 版本:
      node -v # 应该打印出 "v22.19.0".

      # 下载并安装 pnpm:
      corepack enable pnpm

      # 验证 pnpm 版本:
      pnpm -v
      ```
    </CodeGroup>

  </Step>

  <Step title="安装 xiaozhi-client 命令行工具">
    <CodeGroup>
    ```bash pnpm
    pnpm install -g xiaozhi-client
    ```

    ```bash npm
    npm install -g xiaozhi-client
    ```
    </CodeGroup>
  </Step>

  <Step title="创建应用">
    ```bash
    # 创建应用
    xiaozhi create my-app

    # 进入应用目录
    cd my-app

    # 安装依赖
    pnpm install
    ```
  </Step>

  <Step title="设置小智接入点">
    小智AI配置MCP接入点的 [使用说明](https://ccnphfhqs21z.feishu.cn/wiki/HiPEwZ37XiitnwktX13cEM5KnSb)
    ```bash
    xiaozhi config set mcpEndpoint "<从小智服务端获取到的接入点地址>"
    ```
  </Step>

  <Step title="启动服务">
    ```bash
    xiaozhi start
    ```
  </Step>

  <Step title="验证是否成功">
    最后，请前往小智服务端，检查对应的接入点，刷新后是否能获取到工具列表
  </Step>
</Steps>
